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Introduction 

The PROTOCOL.INI file contains information about configuration and binding for all NDIS 
protocols and Media Access Control (MAC) modules. 

Network drivers in the DOS and OS/2 LAN Manager products are loaded and configured with 
entries in the CONRG.S YS (CONFIG.OS2 for dual boot systems) and PROTOCOL.INI files. 
When the LAN Manager stans up, the Protocol Manager program reads the PROTOCOL.INI file 
and binds the protocol and MAC modules together using the parameters and information supplied in 
the PROTOCOL.INI file. 

This process has two parts. During the initial loading and starting of the operating system, the 
device drivers named in the CONFIG.SYS file are loaded and their initialization routines are 
executed. Among these device drivers are the protocol manager (PROTMAN.OS2 or 
PROTMAN.DOS) and both NDIS/MAC drivers and NDIS/protocol drivers. The protocol manager, 
as part of its initialization, reads the PROTOCOL.INI file and saves its contents. 

The second part of the process occurs during run-time, when the program NETBIND.EXE is run 
either from the command Hne or from a batch file such as AUTOEXEC.BAT or STARTUP.CMD. 
At this time, the NETBIND program causes the protocol manager to call each NDIS module (MACs 
and protocols), pass each the PROTOCOL.INI contents, and bind all the modules together as 
specified within PROTOCOL.INI. 

Changes you make to PROTOCOL.INI entries do not take effect until you restart the system. 

Syntax of the PROTOCOL.INI File 

The PROTOCOL.INI file consists of a series of named sections. The format for entries in the 
PROTOCOL.INI file is shown in the following example: 

[ETHERLINK.PLUS] 

DRIVERNAME = ELNKPL$ 

INTERRUPT = 3 

IOADDRESS = 0x300 

DMACHANNEL = 1 
; Be sure the interrupt does not conflict with other adapter cards. 
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In this example: 

• Names of sections are enclosed in square brackets [ETHERLINK_PLUS]. All sections contain 
the keyword drivername, (which identifies the driver). In addition, most sections have the 
keyword bindings (which serves to connect the various modules together). The section name 
itself is an arbitrary label that identifies the section to the other sections (for example, when 
resolving bindings). 

• Entries in sections start at the beginning of a line and are followed by an equal sign (=) and the 
value assigned to the entry. There can be spaces before and/or after the equal sign. 

• Comment text (text that is ignored by the system), starts with a semicolon at the beginning of 
each line. Blank lines are permitted for formatting purposes. 

• Text in the PROTOCOL.INI file is changed to uppercase by the Protocol Manager, with the 
exception of comment text. Unless otherwise specified, text values can be composed of letters, 
numbers, or the following characters: 

$%;-_@{}~M#() 



What the PROTOCOL.INI File Contains 

The PROTOCOL.INI file consists of different sections containing entries related configuring 
network drivers. The following table shows (in alphabetical order) typical PROTOCOL. INI sections 
and their functions. (Remember, section names are arbitrary so your PROTOCOL.INI file may be 
different.) 

Table 1. PROTOCOL.INI File Sections Summary 



Section 


Function 


EtherLink 
EtherLink II 
EtherLink Plus 
EtherLink/MC 
TokenLink 
TokenLink Plus 
SServer 


Configuration values for a 3Com EtherLink adapter. 
Configuration values for a 3Com EtherLink II adapter. 
Configuration values for a 3Com EtherLink Plus adapter. 
Configuration values for a 3Com EtherLink/MC adapter. 
Configuration values for a 3Com TokenLink adapter. 
Configuration values for a 3Com TokenLink Plus adapter. 
Driver for 3Com 3Servers. 



Protcx)ol Manager Binding: 

NETBINDandthe 

PROTOCOL.INI File 



3Com EtherLink Adapter Section 

The EtherLink driver has one required entry, DRIVERNAME. The following table shows (in 
alphabetical order), the possible entries and values for the EtherLink adapter section of the 
PROTOCOL.INI file. 

Table 2. EtherLink Adapter Driver Entries 



Entry 



Explanation of Option Values 



DMACHANNEL= 



DMAMODE= 



DRIVERNAME^ 
INTERRUPT= 



IOADDRESS= 



Used to indicate the current DMA jumper configuration of the adapter. 
NONE = Driver uses program I/O instead of DMA for data transfers. 

1 = Use DMA channel 1. 

2 ■ = Use DMA channel 2. 

3 = Use DMA channel 3. 
Default = 1 When running under DOS. 
Default = NONE When running under OS/2. 

Specifies the DMA mode for the adapter. 
BURST = Use BURST mode. 
BYTE = Use BYTE mode. 
Default = BURST. 

The Adapter runs faster in BURST mode. If BURST mode causes 
contendon with other DMA devices, use BYTE mode. 

NOTE: If DMACHANNEL is set to NONE, the DMAMODE entry is 
ignored. 

ELNK$ (required entry). If there is a second EtherLink adapter, its 
name is ELINK2$. 

Indicates the current interrupt level configuration of the adapter. 
Available = 2-7. 
Default = 3. 

NOTE: On a 286 or 386 computer, interrupt level 2 = interrupt level 9 
because of the cascaded PIC already using interrupt level 2. 

Indicates the current I/O address jumper configuradon of the adapter. 
Available = 0x200 to Ox3fO 
Default = 0x300 

NOTE: The 10 ADDRESS entry must match the switch setting on the 
adapter card. 
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Table 2. EtherLink Adapter Driver Entries, cont. 



Entry 


Explanation of Option Values 


MAXREQUESTS= 

MAXTRANSMITS= 
NETADDRESS= 


This is the number of general request queue entries. (General requests 
are SetPacketFilter, AddMultiCastAddress, and Requestlntemipt, etc.) 
Available = 8 to 32, 
Default = 8. 

The number of transmit queue entries in the MAC driver. 
Available = 8 to 50. 
Default = 12. 

Used to override the network address of the card to a user specific 
address. This parameter is a hexadecimal string of exactly 12 digits, 
enclosed by double quotes (""), for example: 

NETADDRESS ="02608C010O01". 



3Com EtherLink li Adapter Section 

The EtherLink II driver has one required entry, DRIVERNAME. The EtherLink II Adapter does not 
implement the LOOPBACK function, so you must add a LOOPBACK = 4 entry to the DLC section 
when using this adapter. The following table shows the possible entries and values for the EtherLink 
II adapter section of the PROTOCOL.INI file. 

Table 3. EtherLink il Adapter Driver Entries 



Entry 


Explanation of Option Values 


DATATRANSFER= 
DEMAND_DMA 


Sets the data transfer mode on the adapter card. Keywords are: 
BLOCK_DMA Only valid for 8086 and 8088 PCs. 

Only valid for 8086 and 8088 PCs. If the DMACHANNEL entry is set 
to 1, the default for DATATRANSEHR becomes DEMAND DMA. 
PIO BY TH For 80286 and 80386 computers only. 
PIO WORD For 80286 and 80386 computers only. 
SINGLE_DMAOnly valid for 8086 and 8088 PCs. 

NOTE: On an 80286 or 80386 PC, the DMACHANNEL keyword is 
ignored and the default becomes PIO_WORD. 
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Table 3. EtherLink il Adapter Driver Entries, cent. 



Entry 


Explanation of Option Values 


DMACHANNEL= 


Used to indicate the current DMA jumper configuration of the adapter. 
NONE = Driver uses program I/O instead of DMA for data transfers. 

1 = Use DMA channel 1. 

2 = Use DMA channel 2. 

3 = Use DMA channel 3. 

Default = 1 When running under DOS. 
Default = NONE When running under OS/2. 


DRIVERNAME= 


ELNKII$ (required entry). If there is a second EtherLink n driver, its 
name is ELNKII2$. 


INTERRUPT= 


Sets the interrupt level for the adapter card. 
Available = 2-5. 
Default = 3. 




On a 286 or 386 computer, interrupt level 2 = interrupt level 9 
because of the cascaded PIC already using interrupt level 2. 


IOADDRESS= 


Indicates the current I/O address jumper configuration of the adapter. 
Available = 0x200 to Ox3FO 
Default = 0x300 




NOTE: The 10 ADDRESS entry must match the switch setting on the 
adapter card. 


MAXTRANSMITS= 


The number of transmit queue entries in the MAC driver. 
Available = 8 to 50. 
Default = 8. 


NETADDRESS= 


Overrides the network address of the card to a user specific address. 
This parameter is a hexadecimal string of 12 digits in double quotes, 
such as NETADDRESS = "02608C0 10001". 


TRANSCEIVER= 


Sets the transceiver on the adapter card. 

EXTERNAL. Used for a DIX connection. 

ONBOARD. 

Default = ONBOARD. 
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3Com EtherLink Plus Adapter Section 

The EtherLink Plus driver has one required entry, DRIVERNAME. The following table shows (in 
alphabetical order), the possible entries and values for the EtherLink Plus adapter sectiom of the 
PROTOCOL.INI file. 

Table 4. EtherLink Plus Adapter Driver Entries 



Entry 



Explanation of Option Values 



DMACHANNEL= 



DRIVERNAME: 
INTERRUPT= 



IOADDRESS= 



MAXTRANSMITS: 



NETADDRESS= 



Sets the DMA channel for the card. 
Available =1-7 
Default = 3 

NOTE: The DMACHANNEL entry must match the jumper setting on 
the adapter card. 

ELNKPL$ (required entry). If there is a second EtherLink Plus adapter, 
its name is ELNKPL2$.* 

Sets the interrupt level for the adapter card. 
Available = 2-15 
Default = 3 

On a 286 or 386 computer, interrupt level 2 is really interrupt level 9 
because of the cascaded PIC already using interrupt level 2. 

NOTE: The INTERRUPT entry must match the jumper setting on the 
adapter card. 

Indicates the current I/O address jumper configuration of the adapter. 

OtoOx3FO 

Default = 0x300 

NOTE: The lOADDRESS entry must match the jumper setting on the 
adapter card. 

The number of transmit queue entries in the MAC driver.* 
Available = 8 to 50 
Default = 8. 

Overrides the network address of the card to a user specific address. 
This parameter is a hexadecimal string of 12 digits in double quotes, 
such as NETADDRESS = "026080010001". 



* Not supported in this release (3+Open 1.0.) 



Protcxjol Manager Binding: 

NETBIND and the 

PROTOCOL.INI File 



3Com EtherLink/MC Adapter Section 

The EtherLink/MC driver has one required entry, DRIVERNAME. The following table shows (in 
alphabetical order), the possible entries and values for the EtherLink Plus adapter section of the 
PROTOCOL.INI file. 

Table 5. EtherLink/MC Adapter Driver Entries 



Entry 


Explanation of Option Values 


DRIVERNAME= 
MAXTRANSMITS= 

NETADDRESS= 

SLOTNUMBER= 


ELNKMC$ (required entry). If there is a second EtherLink/MC, its 
name is ELNKMC2$. 

The number of transmit queue entries in the MAC driver. 
Available = 8 to 50 
Default = 8. 

Overrides the network address of the card to a user specific address. 
This parameter is a hexadecimal string of 12 digits in double quotes, 
such as NETADDRESS = "02608C0 10001". 

Specifies the slot number in the computer within which the card resides. 

Available = 1-8 

Default = The lowest numbered slot containing an adapter of this type. 

Use this parameter to override the default of the lowest numbered slot. 
For example, if you are using two adapter cards, both cannot be lowest 
numbered so you must specify this keyword for at least one of them. 
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3Com TokenLink Adapter Section 

The TokenLink driver has one required entry, DRIVERNAME. The following table shows (in 
alphabetical order), the possible entries and values for the TokenLink adapter section of the 
PROTOCOLJNIfile. 

Table 6. TokenLink Adapter Driver Entries 



Entry 


Explanation of Option Values 


DRIVERNAME= 
NETADDRESS= 

IOADDRESS= 
DMACHANNEL= 

INrHRRUPT= 


TLNK$ (required entry)> If there is a second TokenLink adapter, its 
name is TLNK2$ 

Overrides the network address of the card to a user specific address. 
This parameter is a hexadecimal string of 12 digits in double quotes 
(""), for example: 

NETADDRESS = "02608 C 11 AAOC. 

Sets the (unique) I/O address of the card. 
0x300 to Ox3FO 
Default = 0x300 

NOTE: This address must be the same as the address set on the adapter 
card. 

Sets the DMA channel on the adapter card. 

Use string I/O move instructions to transfer data from adapter cards 
to memory. An 8086 or 8088 computer uses programmed VO. 

1 Forces a 80286 or 80386 computer to use bus master mode. If bus 
master mode is not supported by your computer, string 1/0 move 
instructions are used instead. 

2 Use DMA channel 2. 

3 Forces a 80286 or 80386 computer to use bus master mode 
4-7 Use the specified DMA channel. 

Default =1. 

Sets the interrupt level for the adapter card. 
Available = 2-5 
Default = 3. 

NOTE: On a 286 or a 386 computer, interrupt level 2 is really interrupt 
level 9 because of the cascaded PIC already using interrupt level 2. 



Table 6 is continued on the next page. 
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Table 6. TokenLink Adapter Driver Entries, cent. 



Entry 


Explanation of Option Values 


SPEED= 
MAX'rRANSMITS= 


Sets the clock on the host computer to maximize data transfer between 

the host computer and the adapter card. 

6 Inserts two wait states on the bus, 

8 Inserts 1 wait state on the bus. 

10 Does not insert any wait states on the bus. 

Default = 6. 

NOTE: Some experimentation may be required for best perfomiance. 
If this parameter is set incorrectly, the adapter card may not run. 

Specifies the number of transmit queue entries in the MAC driver. 
6 to 50. 
Default = 6. 



SServer Driver Section 

The SServer driver has one required entry, DRIVERNAME. The following table shows (in 
alphabetical order), the possible entries and values for the SServer driver section of the 
PROTOCOL.INI file. 



Table 7. 3Server Driver Entries 


Entry 


Explanation of Option Values 


DRIVERNAME= 


E3S386$ (Required entry) 


NETADDRESS= 


Overrides the network address of the card to a user specific address. 
This parameter is a hexadecimal string of 12 digits in double quotes 
(""), for example: 




NETADDRESS = "02608C0 10001". 


RECVBUFS= 


Configures the receive buffers for the driver. 
Available = 15-43 
Default = 32. 
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A Sample PROTOCOL.INI File 

The following is a sample PROTOCOL.INI file for a 3Com server. This file is actually a template 
for the PROTOCOL.INI file the installation process creates. The installation program takes this 
template, modifies it according to the particular installation choices specified, then creates the 
PROTOCOL.INI file. Therefore the exact contents of any particular PROTOCOL.INI file depend 
on the protocols and adapters specified during the installation process. Protocol sections labeled 
DLC, NETBEUI, and XNS_NB have been added for completeness. 

[TOKENLINK] 

DRIVERNAME = TLNK$ 
INTERRUPT = 3 
lOADDRESS = 0x300 
DMACHANNEL = 1 

[ETHERLINK] 

DRIVERNAME = ELNK$ 
lOADDRESS = 0x300 
DMACHANNEL = 1 
INTERRUPT = 3 

[ETHERLINK_PLUS] 

DRIVERNAME = ELNKPL$ 
lOADDRESS =0x300 
DMACHANNEL = 1 
INTERRUPT = 3 

[ETHERLINKII] 

DRIVERNAME = ELNKII$ 
INTERRUPT = 3 
lOADDRESS = 0x300 
DMACHANNEL=1 
XMITBUFS = 1 

[ETHERLINK/MC] 

DRIVERNAME = ELNKMC$ 

[3SERVER] 

DRIVERNAME = E3S386$ 
RECVBUFS = 32 

[XNS.NB] 

DRIVERNAME = XNSNB$ 
BINDINGS = 
MAXSESS = 32 
MAXNCB = 32 
MAXDGBUF=2 
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MAXSNBUF = 8 
MAXRECVBUF = 12 
RECVWINDOW = 
XMITWINDOW = 
MAXCACHE = 2 
MAXREMMAP = 2 
MAXLCLMAP = 2 
STOREFORWARD = NO 
HARDWAREBUF = NO 
LOCATOR = NO 
ROUTEl = 
R0UTE2 = 
ROUTES = 
R0UTE4 = 
R0UTE5 = 
ROUTE6 = 
ROUTE? = 
ROUTES = 



[DLQ 

DRIVERNAME=MDLC$ 
BINDINGS= 

[NETBEUI] 

DRIVERNAME=MNETB$ 
BINDINGS=DLC 



